package com.smh.yunpicturebackend.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.smh.yunpicturebackend.pojo.domain.Picture;
import com.smh.yunpicturebackend.pojo.domain.Space;
import com.smh.yunpicturebackend.pojo.dto.space.SpaceAddRequest;
import com.smh.yunpicturebackend.pojo.dto.space.SpaceDeleteRequest;
import com.smh.yunpicturebackend.pojo.dto.space.SpaceQueryRequest;
import com.smh.yunpicturebackend.pojo.vo.space.SpaceVO;

/**
 * @author shiminghui
 * @description 针对表【space(空间)】的数据库操作Service
 * @createDate 2025-06-23 21:35:07
 */
public interface SpaceService extends IService<Space> {

    /**
     * 创建空间
     *
     * @param spaceAddRequest
     * @return
     */
    long addSpace(SpaceAddRequest spaceAddRequest);

    /**
     * 校验空间
     *
     * @param space space
     * @param add   是否为创建时检验
     */
    void validSpace(Space space, boolean add);

    /**
     * 获取空间包装类（单条）
     *
     * @param space
     * @return
     */
    SpaceVO getSpaceVO(Space space);

    /**
     * 获取空间包装类（分页）
     *
     * @param spacePage
     * @return
     */
    Page<SpaceVO> getSpaceVOPage(Page<Space> spacePage);

    /**
     * 获取查询对象
     *
     * @param spaceQueryRequest
     * @return
     */
    QueryWrapper<Space> getQueryWrapper(SpaceQueryRequest spaceQueryRequest);

    /**
     * 根据空间级别填充空间对象
     */
    void fillSpaceBySpaceLevel(Space space);

    /**
     * 删除空间
     *
     * @param spaceDeleteRequest 空间删除请求
     * @return 是否删除成功
     */
    boolean deleteSpace(SpaceDeleteRequest spaceDeleteRequest);

    /**
     * 添加图片到空间
     *
     * @param spaceId 空间id
     * @param picture 图片
     * @return 是否添加成功
     */
    boolean addPictureToSpace(long spaceId, Picture picture);

    /**
     * 修改图片空间
     *
     * @param spaceId    空间id
     * @param picture    图片
     * @param oldPicture 旧图片
     * @return 是否修改成功
     */
    boolean updatePictureToSpace(long spaceId, Picture picture, Picture oldPicture);

    /**
     * 删除图片空间
     *
     * @param spaceId 空间id
     * @param picture 图片
     * @return 是否删除成功
     */
    boolean deletePictureFromSpace(long spaceId, Picture picture);

    /**
     * 校验空间权限
     *
     * @param space 空间
     */
    void checkSpaceAuth(Space space);
}
